home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 076-100 / scopedisk100 / ctype / readme < prev   
Encoding:
Text File  |  1995-03-19  |  8.8 KB  |  214 lines
  1.  
  2.    --------------------------------------------------------------------
  3.              Ctype 1.0     Bill Nelson - Midnight Logic Software
  4.    --------------------------------------------------------------------
  5.  
  6.                 THIS IS A FREELY REDISTRIBUTABLE PROGRAM
  7.  
  8.  
  9.              This means that it *IS* copyrighted, but it may be
  10.              distributed without charge other than for media. It
  11.              may be placed on BBS's, it may be kept in User Group
  12.              Libraries, and of course (a SPECIAL CASE) it may be
  13.              used by Fred Fish as he might decide!  Enjoy...
  14.  
  15.    ---------------------------------------------------------------------
  16.  
  17.    Any questions, suggestions, or neat stuff of your own may be sent to:
  18.  
  19.                               Bill Nelson
  20.                            8D-2310 Gaetz Ave
  21.                            Red Deer, Alberta
  22.                                 CANADA
  23.                                T4R  1C5
  24.  
  25.                              or to SYSOP at
  26.  
  27.                             Fly-By-Wire BBS
  28.                              403-346-9965
  29.  
  30.                           300/1200/2400 24 hrs
  31.  
  32.    ----------------------------------------------------------------------
  33.    
  34.       The Amiga is a wonderful machine, but it is NOT the most accessible to
  35.    those just trying to learn to program it (especially in Assembly!).  Most
  36.    of the source code out there is in C, and is thus mostly inscrutable- and
  37.    the machine is QUITE complicated enough (with its rich environment of
  38.    System routines) without one also needing a translator for the examples!
  39.  
  40.       So - as a result of that, I decided to attempt a small, useful program
  41.    in Assembly - figuring that by the time it was running as desired, I
  42.    would know a great deal more.  The next problem, of course, was WHAT to 
  43.    write! The sheer volume of Freely Redistributable software (especially 
  44.    utilities!) is almost overwhelming - and there aren't many gaping holes
  45.    anymore!  However, ONE thing I hadn't seen done in a way I liked was a
  46.    TEXT FILE READER.
  47.  
  48.    What?  ANOTHER Text Reader program?  What about MORE - LESS - VIEWER -
  49.    RD - READER and others?  'Fraid so - another one - here are the reasons.
  50.  
  51.    1) Many of the likely candidates have insisted on a certain size of 
  52.       screen, or font, or number of lines, or something.
  53.  
  54.    2) Many of them made multiple invocations difficult (by opening their
  55.       own screens, CHIP RAM soon becomes a vanishing commodity!)
  56.  
  57.    3) Few of them did anything ELSE with the file except display it - and
  58.       those that did insisted on doing it only one way (or to the whole
  59.       thing!).
  60.  
  61.  
  62.    So - Presenting CTYPE (or CT, when installed in your C: directory?)
  63.  
  64.    ----------------------------------------------------------------------
  65.  
  66.              Features:
  67.              ---------
  68.  
  69.    1) Opens a window on your WorkBench screen, using the current settings
  70.       from YOUR preferences (including any MoreRows'd additions).
  71.  
  72.  
  73.    2) Does not disturb, and will USE the font YOU have chosen (for instance
  74.       with SetFont) [thanks Dave Haynie!]
  75.  
  76.  
  77.    3) Have you ever been annoyed at a file that was written to be a LITTLE
  78.       wider than YOUR screen defaults?  I do a (primitive!) word-wrap for
  79.       you - at least you'll have the whole WORD on the next line!
  80.  
  81.  
  82.    4) Will allow progress through the file by PAGE or LINE in any direction.
  83.       When displaying by PAGE will clear the screen (leading to a consider-
  84.       able speed-up on LARGE screens).
  85.  
  86.  
  87.    5) Will facilitate moving through a file by allowing both CASE SenSitIve
  88.       and non sensitive searches.  A touch of the "N" key will repeat the
  89.       last search command (maintaining the state of case sensitivity).
  90.  
  91.  
  92.    6) Allows the reading of files to be broken up into convenient sessions,
  93.       by supporting a "goto this place" function - or more accurately, goto
  94.       a given percentage.
  95.  
  96.  
  97.    7) If you find something interesting, you can get hardcopy at any time,
  98.       either of the whole file, or of the currently displayed screen.  Of
  99.       course, YOU define WHERE the printing goes, any valid AmigaDOS file
  100.       or port will be accepted (with PRT: the default of course).
  101.  
  102.  
  103.    8) Will work from either the CLI or the WorkBench - because the Amiga 
  104.       has BOTH for a good reason :-)
  105.  
  106.  
  107.    9) Always has HELP available, and the basic prompts are always displayed.
  108.       Yes, and the help is actually selected by the HELP key!  
  109.  
  110.  
  111.   10) If all this is NOT enough - I will capitulate.... and call your own
  112.       EDITOR for you.  This assumes that you have an entry in your environ-
  113.       ment that tells me WHAT your editor's name is, of course!  Anything,
  114.       in fact, that is found in a file ENV:EDITOR I will attempt to execute
  115.       for you...
  116.  
  117.  
  118.    -------------------------------------------------------------------------
  119.  
  120.  
  121.    USING THE PROGRAM
  122.  
  123.  
  124.    Not too much to say here - it is NOT a fancy user interface, but I like
  125.    to think it IS an effective one.  Rather than stick with one person's
  126.    idea of the "right" keys to use for a given result, I have attempted to 
  127.    allow the use of ALL the keys that make ANY sense at all, or have been
  128.    expected by convention.  In particular this meant that the Page Down 
  129.    function (for instance) can be called by ANY of the following:
  130.  
  131.    the SPACE bar      - by convention in countless MORE-type programs
  132.    shifted cursor key - by logic
  133.    PgDn Key (num pad) - so people who have to work on PC's can use it too!
  134.  
  135.    Most of the rest of the commands are implemented in a similar way, so
  136.    pretty much anything can be done the way you like it.  Those commands
  137.    (such as Search and Goto %) that require input are activated in the same
  138.    way as they are on Commodore's MORE 3.27 program.  
  139.  
  140.    By the way, the number pad commands (PgDn, PgUp, Home etc) were
  141.    implemented the "cheap" way, so that the number that is on the top of the
  142.    key will work as an alternative input.  In particular that means that
  143.    A1000 users can also hit the "3" key, even though their keyboard doesn't
  144.    SAY it calls PageDown!  Of course, as an A1000 does not HAVE a PrtSc key
  145.    (based on the number pad's * key) - they will have to call that function
  146.    from the top row of the main keyboard, or perhaps from the F7 key if they
  147.    prefer.
  148.  
  149.    If a command requires more input from the user, the prompt line at the
  150.    bottom of the screen is cleared, the keystroke is echoed, and the cursor
  151.    is turned on.  Hopefully this will be clear to you when you try out the
  152.    different features!
  153.  
  154.    By the way, if the search string you have specified IS located, the line
  155.    it is contained in will be displayed at the top of the screen.  There is
  156.    no other highlighting done to it - but hopefully this will be enough
  157.    information for you to find it on your screen.
  158.  
  159.    One final note on usage - I have this program in the C: directory as CT,
  160.    and hiding in the S: directory is a little script file (included in the
  161.    archive, but easily duplicated!) I call HT; which makes a RAM: copy of
  162.    the output of the TYPE OPT H command, and feeds THAT to CType.  This
  163.    enables this program to handle binary files too! :-)   Of course, under
  164.    1.3 you can have the script bit set, and make the file automatically
  165.    executable when you enter its name - without having to type "EXECUTE HT"
  166.    to make it run....
  167.  
  168.  
  169.    -------------------------------------------------------------------------
  170.  
  171.  
  172.    LAST THOUGHTS
  173.  
  174.    
  175.    I had a LOT of fun writing this program (and yes, I think I *DID* learn
  176.    something).  In hopes of making it easier for someone else just learning
  177.    Assembly on the Amiga, the source code is included.  Perhaps SOME of the
  178.    code (and comments) will make it easier to see how it all works.  PLEASE
  179.    feel free to use any of the code you wish in programs of your own that
  180.    are intended for free distribution - but include a reference in your docs
  181.    or source to the person who sweated it out first, OK?  I retain the
  182.    copyright to the code as whole, and do not wish any commercial use to be
  183.    made of the program (not that any of the code is that good, probably, 
  184.    anyway :-) unless I am contacted first...
  185.  
  186.    Finally  - many thanks to the Beta testers (OK - entymologists!) who both
  187.    helped squash the bugs, and pestered me for improvements where they were
  188.    sorely needed!
  189.  
  190.                              Michael Velez
  191.                              Rob Zelt
  192.                              Brad Nelson
  193.                              Niel Ericson
  194.                              Doug McNeil
  195.  
  196.    and others from 
  197.  
  198.                         Amiga User's of Calgary
  199.                               (A.M.U.C.) 
  200.  
  201.    and the               
  202.  
  203.                    Central Alberta Amiga Owner's Society
  204.                              (C.A.A.O.S.)
  205.  
  206.  
  207.  
  208.    who also contributed.  Thank you one and all!!
  209.  
  210.  
  211.    Bill Nelson       00:00:01  8 August, 1989
  212.  
  213.    -------------------------------------------------------------------------
  214.